home *** CD-ROM | disk | FTP | other *** search
/ Now That's What I Call Games 1 / Now That's What I Call Games (1993)(Multi Media Machine)[!][CD32-CDTV].iso / shareware / diplomacy / ins.doc < prev    next >
Text File  |  1993-09-11  |  18KB  |  530 lines

  1. This program is an original implementation of
  2. the classic board game,  DIPLOMACY,  for  the
  3. Amiga. It is being distributed  as  shareware
  4. and may be copied and distributed  freely  as
  5. long as  the  files  listed  above  are  kept
  6. together as a set. If you keep and  use  this
  7. program, please send a minimum of $10 to  the
  8. author:
  9.  
  10. Steve Douthat
  11. 10661 Escobar Drive
  12. San Diego, CA  92124
  13.  
  14. Comments, suggestions  and  bug  reports  are
  15. also appreciated. Persons who donate  $20  or
  16. more  will  automatically  receive  the   'C'
  17. source code and any subsequent revisions   of
  18. this program.
  19.  
  20. The program will display the title screen  as
  21. it reads in the data and sets  up  the  game.
  22. Click the left mouse button when prompted  to
  23. reveal the diplomacy campaign map  and  start
  24. the game.
  25.  
  26. THE GAME
  27.  
  28. BACKGROUND
  29.  
  30. The  game  DIPLOMACY  is  a   conquer-the-map
  31. type game which is published by Avalon  Hill.
  32. It  is  designed  for  seven   players   with
  33. variations for as few as  two  players.  This
  34. software is designed to enhance this game  by
  35. keeping  track  of  the  various  parameters,
  36. resolving  the  orders  and  controlling  the
  37. flow. This documentation  describes  the  use
  38. of this software only. Please  refer  to  the
  39. rule book included in Avalon Hill's game  for
  40. the complete set of game instructions.
  41.  
  42. The game of  diplomacy  is  played  in  years
  43. consisting of three seasons: Spring, Fall and
  44. Winter. The Spring and Fall  turns  are  when
  45. the players  issue  orders  for  movement  of
  46. their existing units (armies and fleets).  In
  47. the Winter turn, supply center  ownership  is
  48. adjusted and units  are  built  or  disbanded
  49. accordingly. The game starts in Spring of the
  50. year 1901.
  51.  
  52. ISSUING ORDERS (Spring and Fall turns)
  53.  
  54. There are  three  possible  orders  for  each
  55. unit on the board: hold, move or support.  In
  56. addition,  fleets  have  a   fourth   option,
  57. "convoy"  of  an  army  from  one  coast   to
  58. another. In general,  orders  are  issued  by
  59. selecting the  provinces  involved.  This  is
  60. done by moving the mouse pointer to the  name
  61. of the province and clicking the  left  mouse
  62. button. Each order requires 3 provinces:  the
  63. province containing the unit  being  ordered,
  64. the province  containing  the  unit  that  is
  65. moving,   and   the   destination   province.
  66. Clicking on these three provinces is  usually
  67. enough to fully describe the order.
  68.  
  69. HOLD:  click  three  times  on  the  province
  70. containing the unit. (remember  to  click  on
  71. the NAME of the province)
  72.  
  73. MOVE: click twice on the province  containing
  74. the unit to move; click  the  province  where
  75. the  unit  is  going.  If   the   destination
  76. province is multi-coast and the  unit  moving
  77. is a fleet, a  requester  may  appear  asking
  78. which coast.
  79.  
  80. SUPPORT: click the  province  containing  the
  81. unit  providing  the   support;   click   the
  82. province containing the  unit  receiving  the
  83. support;  click  the   province   where   the
  84. supported unit is going/staying. if       the
  85. supporting unit is a fleet in the  water  and
  86. the supported unit is an army on  the  coast,
  87. then  a  requester  may  ask  you  to  select
  88. between   "support"   or   "convoy";   select
  89. "support".
  90.  
  91. CONVOY: same as SUPPORT but  select  "convoy"
  92. at requester. Note that a convoy order is not
  93. valid unless the army being convoyed is  also
  94. ordered to move to the same province.
  95.  
  96. A text representation of the  order  will  be
  97. constructed at the top of the screen as  each
  98. order is input. The entire list of orders can
  99. be viewed on-screen or  printed  out  at  any
  100. time during  order  entry  by  selecting  the
  101. proper item on  the  STATUS  menu  (see  menu
  102. commands below). Any order which is incorrect
  103. can be changed by simply entering the correct
  104. order. Note that virtually all  orders,  even
  105. those  which  are  obviously   invalid,   are
  106. accepted by the computer during order  entry.
  107. It is important to  verify  that  the  orders
  108. have been entered as intended prior to ending
  109. the  order  input  phase.  Orders  which  are
  110. invalid  will  be  flagged  as  such  in  the
  111. results of the order resolution and the order
  112. will be treated as a HOLD order.
  113.  
  114. When all orders have been entered  correctly,
  115. a click on the end gadget in the lower  right
  116. corner will signal the  computer  to  resolve
  117. the orders.
  118.  
  119. ISSUING  RETREAT  ORDERS  (Spring  and   Fall
  120. turns)
  121.  
  122. Some units may be dislodged as  a  result  of
  123. order  resolution.  If  this  is  true,   the
  124. computer will wait for retreat orders  to  be
  125. issued. These are entered similar to  regular
  126. orders but are simpler: The default order  is
  127. to disband a dislodged  unit.  To  command  a
  128. unit to  retreat,  click  the  province  from
  129. which the unit is being  dislodged  and  then
  130. click the destination province. To change the
  131. order back to a disband order, click twice on
  132. the unit's  province.  The  list  of  retreat
  133. orders can be displayed  similar  to  regular
  134. orders using the menu. Click the  end  gadget
  135. when all orders have been entered correctly.
  136.  
  137. ADJUSTING UNITS (Winter turn)
  138.  
  139. At  the   end   of   the   Fall   turn,   the
  140. computer  will  automatically  adjust  supply
  141. ownership. Then the numbers of supplies owned
  142. will be  compared  to  the  number  of  units
  143. deployed for each power. If appropriate,  the
  144. computer will wait for  build/disband  orders
  145. to be issued.  These  are  issued  by  simply
  146. clicking on the appropriate province and,  if
  147. building on a coastal province, selecting the
  148. type of unit to be built. A power will not be
  149. allowed to issue  more  builds/disbands  than
  150. the supply  count  calls  for.  The  list  of
  151. adjustment orders can be displayed similar to
  152. regular orders using the menu. An  order  can
  153. be cancelled  by  clicking  on  the  province
  154. again. Click the end gadget when  all  orders
  155. have been entered correctly.
  156.  
  157. If insufficient  units  are  selected     for
  158. disbanding,   additional   units   will    be
  159. disbanded based on  location  as  though  the
  160. power were in civil disorder.
  161.  
  162. THE FILES
  163.  
  164. MAP FILES
  165.  
  166. "Default.map" is an IFF picture  of  the  map
  167. background which is loaded when  the  program
  168. is  started.  It  is  HIRES  (640x200  pixel)
  169. resolution and has 8 colors. It was drawn  by
  170. Ken  Edwards,   a   user/artist   in   Texas.
  171. "Lace1.map" is  the  same  map  converted  to
  172. INTERLACE   (640x400    pixel)    resolution.
  173. "Lace2.map" is slightly larger.
  174.  
  175. You can use  a  paint  program  (e.g.  Deluxe
  176. Paint) to modify these maps or to create your
  177. own. The names of the provinces are part   of
  178. the provdata file and should not be drawn  on
  179. the picture. The resolution you  select,  the
  180. size of the map, and  the  number  of  colors
  181. greatly affects the memory  required  to  run
  182. Diplomacy. The colors you choose will be  all
  183. that's available for the color of each power.
  184. Also, the first four colors in  your  palette
  185. will be used as follows: COLOR 0  -  province
  186. names and background  for  the  text  display
  187. areas COLOR 1 - text in display  areas  COLOR
  188. 6 - assumes land is  this  color  COLOR  7  -
  189. assumes water is this color
  190.  
  191. You can change  the  map  that  the   program
  192. starts   with   by   simply   replacing   the
  193. "default.map".
  194.  
  195. PROVDATA FILES
  196.  
  197. "Default.provdata" contains the locations and
  198. types (land or water) for all the  provinces.
  199. This data corresponds to the default  (HIRES)
  200. map.  "Lace.provdata"   is   for   use   with
  201. "lace.map".
  202.  
  203. You can modify province data using the ADJUST
  204. menu or "Prov  Edit  Mode"  under  the  PREFS
  205. menu. When you open a  map  the  provdata  is
  206. cleared and provdata corresponding to the new
  207. map must be opened or created.
  208.  
  209. GAME FILES
  210.  
  211. "Default.game"     holds     the     starting
  212. configuration (Spring 1901)  for  a  standard
  213. Diplomacy  game  with  seven  human  players.
  214. Since the  names  of  the  provinces  in  the
  215. "lace.provdata"  file  is  the  same  as  the
  216. default, this game file will work with either
  217. map resolution.
  218.  
  219. Game information  changes  as  the  game   is
  220. played. It can also  be  modified  using  the
  221. ADJUST menu.
  222.  
  223. THE MENU
  224.  
  225. PROJECT MENU These  commands    affect    the
  226. entire game and can be used anytime.
  227.  
  228. To Back - sends game screen behind workbench,
  229. etc to allow multitasking control
  230.  
  231. Default Map -  opens  the  "Data/default.map"
  232. IFF picture adjusting the  screen  resolution
  233. and colors to match.  This  operation  erases
  234. all province data and game information.
  235.  
  236. Open Map - same as DEFAULT MAP  but  provides
  237. a requester so you can select  which  picture
  238. file to open. Any IFF picture can be used  as
  239. a background but keep in mind that the screen
  240. will  take  on  the  characteristics  of  the
  241. picture used and  memory  requirements  could
  242. vary greatly.
  243.  
  244. Default     ProvData     -     opens      the
  245. "Data/default.provdata" file. This file  must
  246. correspond to the map  currently  being  used
  247. for the province gadgets to line up  properly
  248. with the background.
  249.  
  250. Open ProvData - same as DEFAULT PROVDATA  but
  251. provides a requester so you can select  which
  252. provdata file to open.
  253.  
  254. Save  ProvData  -   overwrites   last   saved
  255. provdata file  with  current  province  data.
  256. This option is identical  to  "SAVE  PROVDATA
  257. AS" if  the  data  has  not  been  previously
  258. saved.
  259.  
  260. Save ProvData As  -  saves  current  province
  261. data in file  on  disk  for  later  retrieval
  262. using OPEN command.
  263.  
  264. New Game - restarts  game  at  Spring    1901
  265. (or whatever configuration  is  specified  in
  266. "Data/default.game" file).
  267.  
  268. Open  Game  -  loads  previously  saved  game
  269. (requires entry of name of game file).
  270.  
  271. Save Game - overwrites last saved  game  file
  272. with current configuration.  This  option  is
  273. identical to "SAVE GAME AS" if the  game  has
  274. been previously saved.
  275.  
  276. Save   Game   As   -   saves   current   game
  277. configuration  in  file  on  disk  for  later
  278. retrieval using OPEN command.
  279.  
  280. Quit - closes  game  screen  and  returns  to
  281. workbench/CLI.
  282.  
  283. About - shows revision number and credits.
  284.  
  285. STATUS MENU These   commands   provide   data
  286. output to the desired device.
  287.  
  288. Display Orders - shows list on screen of  all
  289. units by power and their current order.  This
  290. option is useful  to  allow  order  entry  to
  291. be double-checked prior to clicking "end" for
  292. results.
  293.  
  294. Display Supplies - shows list of  powers  and
  295. the supply centers  each  currently  owns  on
  296. screen.
  297.  
  298. Print Orders -  outputs  list  of  orders  to
  299. printer.
  300.  
  301. Print Status - outputs current status    info
  302. to printer; includes list of units  for  each
  303. power; this is handy to produce  a  worksheet
  304. for  writing  orders  during  the   diplomacy
  305. period.
  306.  
  307. Save Orders - stores list of orders  as  text
  308. file on disk.
  309.  
  310. Save Status - stores current status  info  as
  311. text file on disk.
  312.  
  313. PREFS MENU This  menu  allows  selection   of
  314. various display and output modes. A check  is
  315. displayed in the menu  next  to  each  option
  316. selected.  Any  combination   is   acceptable
  317. including no output (no check marks).
  318.  
  319. Display Results - shows list on   screen   of
  320. units, their orders and the end result  after
  321. each  turn.  This  option  is   selected   by
  322. default.
  323.  
  324. Print Results - outputs to printer.  This  is
  325. useful in providing a hard  copy  of  results
  326. for reference during game play.
  327.  
  328. Save Results - outputs to a history  file  on
  329. disk. This will preserve  a  history  of  the
  330. game useful for  analysis  and  other  future
  331. reference.
  332.  
  333. Make Sounds - makes a beep  sound    whenever
  334. an error message is displayed.  This  is  the
  335. only sound this game can produce.
  336.  
  337. Auto Save Game - automatically saves game  to
  338. a new disk file after each turn is completed.
  339. Files are named using the root name specified
  340. in the  requester  and  adding  an  extension
  341. indicating the date of the  game  turn.  This
  342. option  is  highly  recommended  in  that  it
  343. protects you against computer resets and lets
  344. you revert back to a previous turn at will.
  345.  
  346. Show Borders - displays  lines  between   the
  347. province  name  gadgets  which   show   which
  348. provinces are bordering each other. The lines
  349. are color-coded to  indicate  which  type  of
  350. unit can traverse the border. Black and brown
  351. lines are for armies only, black and aqua are
  352. for fleets, and brown  and  aqua  means  both
  353. armies and fleets can traverse. (Note: colors
  354. depend on the palette of the map being  used.
  355. This option would typically be used  only  if
  356. creating or modifying the province data.
  357.  
  358. Prov Edit  Mode  -  suspends  game  play  and
  359. allows  easy  access  to  the  map-   editing
  360. features.  Click  in  open  space  to  add  a
  361. province. Click a province gadget to pick  it
  362. up to move (delete it  by  clicking  the  end
  363. gadget while holding it).
  364.  
  365. ADJUST MENU These commands  give   the   user
  366. raw  power  to  adjust  the   game   to   any
  367. configuration. Although  the  game  has  been
  368. play-tested  and  is  believed  tofollow  the
  369. rules   accurately   in   resolving   orders,
  370. gamemasters  can  choose  to  over-ride   the
  371. decisions and adjust the  map  to  what  they
  372. believe is correct. This menu  also  includes
  373. the map editing commands which can be used to
  374. modify the province data.
  375.  
  376. Season - change season.
  377.  
  378. Year - change year.
  379.  
  380. Players - brings up a requester which  allows
  381. player data to  be  modified.  This  includes
  382. names of players, the  power(s)  each  player
  383. controls and whether  the  player  is  to  be
  384. controlled by the computer (AI)  or  not.  If
  385. computer control is  selected,  the  computer
  386. will  issue  all  orders   for   the   powers
  387. controlled by  that  player.  Any  number  of
  388. players can be computer-controlled  and  each
  389. player will act  independently.  To  place  a
  390. power in  civil  disorder,  simply  leave  it
  391. under human (i.e., not computer) control  and
  392. don't issue any orders for  it.  The  default
  393. civil disorder  rules  will  be  followed  in
  394. resolving orders.
  395.  
  396. Powers - brings up a requester  which  allows
  397. power data  to  be  modified.  This  includes
  398. names of powers and color used  to  represent
  399. each power on the map.
  400.  
  401. Unit - build/change/disband a unit. Any  unit
  402. in the province selected is replaced  by  the
  403. unit built.
  404.  
  405. Current Supply -  change  eliminate   current
  406. ownership of a supply province.
  407.  
  408. Home   Supply   -    change/eliminate    home
  409. ownership of a home supply province.
  410.  
  411. Add Province - creates a  new  province  name
  412. gadget on the map with the name you  provide.
  413. You are then prompted  to  establish  borders
  414. with existing provinces. Use the "end" gadget
  415. to indicatewhen all  the  borders  have  been
  416. selected. If the  province  being  added  has
  417. more than one coast, use "Adjust Borders"  to
  418. add the additional border information.
  419.  
  420. Move province - click on province  gadget  to
  421. pick it up and click again  to  drop  in  new
  422. location. Drop the  province  gadget  on  the
  423. "end" gadget to delete it.
  424.  
  425. Rename Province - select  province  and  type
  426. new name in requester gadget.
  427.  
  428. Change Prov Type - change water to  land  and
  429. vice versa. Also to modify supply centers.
  430.  
  431. Adjust  Borders  -   select   province     to
  432. modify, then select the  bordering  provinces
  433. for armies and for each of the four  possible
  434. coasts. Use Show Borders mode (Prefs Menu) so
  435. you can see what you're doing.
  436.  
  437. KNOWN BUGS/LIMITATIONS
  438.  
  439. The computer opponent  is  extremely  limited
  440. in ability  and  this  option  has  not  been
  441. thoroughly debugged. Teaching a  computer  to
  442. actually play this game is  more  challenging
  443. than originally anticipated.
  444.  
  445. Otherwise, there are no  known  bugs.  Please
  446. let me know if you have any problems.
  447.  
  448. NEW TO REVISION 1.1
  449.  
  450. The program now sports a more elaborate  file
  451. requester for saving  and  retrieving  files.
  452. This is the "FileIO Requester" designed by RJ
  453. Mical and included in his Amiga  Programmer's
  454. Suite Book 1.01. It lists  files  in  current
  455. directory   and   allows   movement   through
  456. directories. Thanks RJ!
  457.  
  458. NEW TO REVISION 1.2
  459.  
  460. Now you can save results and game  status  to
  461. a disk file. Output is  controlled  with  its
  462. own menu  and  you  can  now  have  the  game
  463. maintain a history file on  disk  for  future
  464. reference.
  465.  
  466. Also, the map has been greatly  enhanced   by
  467. Ken Edwards, a user/artist in  Texas.  Thanks
  468. Ken!
  469.  
  470. NEW TO REVISION 2.0
  471.  
  472. New features have been added to the  menu  to
  473. greatly assist those who wish to  modify  the
  474. game board or create new worlds  to  conquer.
  475. The menu has been reorganized to  accommodate
  476. these additions.
  477.  
  478. The map now expands to fit the entire  screen
  479. area available. This won't mean  anything  to
  480. most users, but those who have squeezed extra
  481. pixels out of their monitors will be able  to
  482. take advantage of them.
  483.  
  484. Interlace versions of  the  default  map  and
  485. provdata are provided. These  can  be  loaded
  486. from the project menu (load the map first) or
  487. they can replace  the  defaults  by  changing
  488. their names.
  489.  
  490. Orders for retreats, builds and disbands  are
  491. now handled similar to regular orders in that
  492. printing, saving  and  map  viewing  are  all
  493. permitted while issuing these orders.
  494.  
  495. Fixed bug which caused Guru if diplomacy  was
  496. quit while top edge of map is displayed.
  497.  
  498. Fixed bug  in  adjudicating  orders     which
  499. previously  allowed   supported   move   into
  500. province occupied by friendly unit which does
  501. not successfully move out.
  502.  
  503. A warning has been added to the quit sequence
  504. to provide one  last  chance  to  save  files
  505. before the program quits.
  506.  
  507. A computer opponent will play  any    country
  508. or countries independently or as a team  (see
  509. "known bugs/limitations"). This allows for  a
  510. one-player game of World  War  I  or  variant
  511. thereof.
  512.  
  513. PLANNED REVISIONS
  514.  
  515. Port to Macintosh.
  516.  
  517. Fix/improve computer opponent.
  518.  
  519. Diplomacy is Copyright (c) 1976  Avalon  Hill
  520. Game Company
  521.  
  522. Diplomacy for Amiga is  Copyright  (c)  1988,
  523. 1989, 1991 Steve Douthat
  524.  
  525. Amiga  and   AmigaDOS   are   trademarks   of
  526. Commodore-Amiga, Inc.
  527.  
  528.  
  529.  
  530.